package com.tjetc.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.tjetc.entity.CityDetail;

import java.util.List;

/**
 * 城市详情服务接口
 */
public interface CityDetailService extends IService<CityDetail> {

    /**
     * 根据城市名称模糊查询
     * @param name 城市名称
     * @return 城市列表
     */
    List<CityDetail> getCityDetailsByName(String name);

    /**
     * 分页查询城市信息
     * @param page 分页对象
     * @param name 城市名称(可选)
     * @return 分页结果
     */
    IPage<CityDetail> getCityDetailPage(Page<CityDetail> page, String name);

    /**
     * 查询评分大于等于指定分数的城市
     * @param score 最低评分
     * @return 城市列表
     */
    List<CityDetail> getCityDetailsByScoreGreaterThan(Double score);

    /**
     * 根据最佳旅游季节查询城市
     * @param season 季节关键词
     * @return 城市列表
     */
    List<CityDetail> getCityDetailsBySeason(String season);
    
    /**
     * 根据ID获取城市详情
     * @param cityId 城市ID
     * @return 城市详情
     */
    CityDetail getCityDetailById(Long cityId);
    
    /**
     * 新增城市详情
     * @param cityDetail 城市详情对象
     * @return 是否成功
     */
    boolean addCityDetail(CityDetail cityDetail);
    
    /**
     * 更新城市详情
     * @param cityDetail 城市详情对象
     * @return 是否成功
     */
    boolean updateCityDetail(CityDetail cityDetail);
    
    /**
     * 删除城市详情
     * @param cityId 城市ID
     * @return 是否成功
     */
    boolean deleteCityDetail(Long cityId);
    
    /**
     * 根据城市code获取城市详情
     * @param code 城市code
     * @return 城市详情
     */
    CityDetail getCityDetailByCode(Long code);
}

